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1.  INTRODUCTION 

TAM  is  an  interactive  program  which  performs  arithmetic  computations  on  con¬ 
stants,  stored  variables,  and  one-  or  two-dimensional  arrays.  TAM  operates 
from  two-dimensional,  hand-written  input  and  generates  two-dimensional  output. 

TAM  is  fundamentally  a  "one  statement  at  a  time"  system.  Each  statement  is 
accepted  and,  if  legal,  executed  before  the  next  statement  is  requested.  How¬ 
ever,  statements  can  modify  the  TAM  environment  so  that  subsequent  statements 
are  affected.  The  program  can  recall  and  re-execute  previous  statements  and 
has  a  powerful  editing  capability. 

Wherever  possible,  TAM  frees  the  user  from  explicit  or  ordered  declaration. 
Storage  is  acquired  through  usage;  unknown  quantities  are  requested  when  needed. 

TAM  incorporates  a  powerful  set  of  arithmetic  operators  on  constants,  variables, 
and  one-  and  two-dimensional  arrays.  It  also  provider  looping  facilities,  sin¬ 
gle  statement  functions,  and  user-defined  input  and  output. 

Some  built-in  functions,  such  as  logarithm,  and  some  built-in  constants,  such 
as  i*  and  e,  are  provided. 

2.  TAM  ENTITIES 

2.1  QUANTITIES 

Quantities  in  TAM  are  either  positive  or  negative,  integral  or  mixed  numbers. 
Internally,  mixed  numbers  are  carried  in  double-precision,  floating-point 
form;  integers  are  carried  in  one  IBM/360  word  (A  bytes).  Therefore,  effective 
precision  is  that  defined  for  the  IBM/360.  Quantities  may  be  contained  in 
variables  or  arrays  or  expressed  as  constants.  Most  storage  declaration  is 
implied  by  usage.  Arrays  are  dimensioned  either  implictly  or  explicitly. 
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Examples:  3  5.7 


1.0  2 


0  -.37 


L 


3 


.45 


2.2  IDENTIFIERS 

Variables  and  array  Identifiers  are  single-letter  names.  The  legal  alphabet 
of  TAM  consists  of  Greek  and  Roman  uppercase  and  lowercase  letters.  An 
Identifier  may  be  made  unique  through  the  use  of  overscoring  or  underscoring. 
Legal  overscore  and  underscore  characters  are: 


A  .  ► 

Examples  of  legal  Identifiers  are: 

a  A  a 

A  A  a 


3.  TAM  OPERATORS 


3.1  OPERATORS 


Quantities  may  be  manipulated  through  the  use  of  operators  as  follows: 

a  +  b  addition 

a  -  b  subtraction 

ab.a.b ,a*b  multiplication 


b,  a/b 


X 


Y 


division 

exponentiation 


nC^  root  y/~ ~  ■>  3/~ 

!  factorial 

(  }  absolute  value 
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ceiling 

{  } 

floor 

n 

I! 

product 

i«m 

n 

I 

summation 

i*m 

+b,-b 

unary  sign 

T 

transpose  (two-dimensional  arrays 

Note  that  Implicit  multiplication  Is  allowed  because  all  Identifiers  are  single 
letters  (possibly  qualified).  A  special  operator, V.  Is  used  In  conjunction 
with  setting  arrays  and  Is  explained  subsequently. 


3.2  OPERATIONAL  HIERARCHY 

Parentheslzatlon  Is  allowed  to  control  the  parsing  hierarchy.  In  the  absence 
of  parentheslzatlon,  the  hierarchy  of  operation  Is  (from  least  to  most  bine.'  ng) 


I 

n 

*./ 

t 

f  M  l,Ln,( 


summation 

product 

addition,  subtraction 
multiplication,  division 
unary  plus,  unary  minus 
factorial 

floor,  celling,  function  call,  absolute  value, 
root,  exponentiation,  transpose 


3.3  OPERATOR  DEFINITION 

Each  operator  is  usable  when  meaningful.  With  few  exceptions  (for  example, 
transpose  applies  to  matrices  only;  (-3)'  Is  signaled  as  an  error),  all  opera¬ 
tors  are  usable  to  manipulate  single  constants  or  variables.  The  operators 


23  September  1971 


4 


System  Development  Corporation 
TM-4790/000/00 


are  legal  when  applied  to  arrays  where  an  acceptable  matrix  or  vector  operation 
Is  defined.  For  example, 


1 

3 


Is  defined  if  the  matrix  Is  square; 


1 

3 


Is  not  defined; 


is  defined  If  the  divisor  is  a 
square  matrix  and  the  Interior 
dimensions  of  the  two  matrices 
are  the  same; 


and 


'  1  5  ‘ 
7  9 


Is  not  defined. 


One-dimensional  arrays  are  stored  and  treated  as  row  vectors,  with  one  exception. 
In  multiplication,  if  one  or  both  operands  are  vectors,  the  operand  on  the  left 
(if  a  one-dimensional  array)  is  treated  as  a  row  vector  and  the  operand  on  the 
right  (if  a  one-dimensional  array) *is  treated  as  a  column  vector.  Hie  multi¬ 
plication  performed  is  the  dot  product.  Therefore, 


[12  3]* 


14 


S 


A.  TAM  STATEMENTS 

There  are  five  distinct  TAM  statements:  assignment,  function  definition,  input, 
output,  and  loop. 
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4.1  ASSIGNMENT  STATEMENT 

The  assignment  statement  is  used  to  set  identifiable  variables  or  arrays, 
presumably  for  use  in  subsequent  statements. 


4.1.1  Form 

identifier  +■  expression 

The  expression  may  consist  of  any  legal  manipulation  of  quantities. 


4.1.2  Use 

For  example: 


B 


Set  variable  A  to  3.  (1) 

Set  array  B  to  the  given  matrix  (also  (2) 
dimension  B  as  2,  3).  Each  element 
of  the  matrix  B  may  be  any  legal 
expression  that  yields  a  single  numeric 
value. 


C  *■  V  Set  all  elements  of  array  C  to  0  (3) 

!> 

dimension  C  3,  5. 


D 


1 


25.5 


A 


A 

-I 


J-l 


Set  first  element  of  array  D  to  (4) 

25.5.  The  dimensionality  of  D  is 
unknown  as  yet. 

Set  X  to  minus  the  sum  of  the 
elements  of  the  first  row  (A»3)  of  B. 


X 


(5) 
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-VM-C  Set  Y  to  the  sum  of  to  the  -X**1  (6) 

power  and  the  product  of  the  absolute 
value  of  X  and  the  square  root  of  2* 

The  third  example  illustrates  the  use  of  the  special  operator  V.  It  is  used 
to  declare,  dimension,  and  preset  an  array  (of  one  or  two  dimensions).  The 
form  of  the  operator  is: 


where  s  and  t  are  dimensions  (t  and  the  preceding  comma  are  optional)  and  p 
(also  optional)  is  the  presetting  value.  P  may  be  any  legal  expression  that 
yields  a  single  numeric  value. 

4.2  FUNCTION  DEFINITION  STATEMENT 

The  TAM  user  may  define  frequently  used  arithmetic  expressions  as  functions; 
he  may  then  call  upon  these  functions  when  necessary.  Functions,  of  course, 
return  values.  The  function  definition  and  call  may  contain  parameters.  Both 
the  function  expression  and  the  actual  parameters  of  the  call  may  contain  calls 
to  other  functions. 

4.2.1  Form 

f  (Pi»p2* • * *Pm)  "  expression 

where  f  is  a  legal  Identifier,  n  is  an  optional  alphabetic  or  numeric  qualifier, 
and  the  p^  are  optional  parameters.  The  expression  may  involve  any  legal 
manipulation  of  quantities.  The  identifier  f,  once  it  has  been  used  as  a 
function  name,  defines  a  class  of  functions  f  and  cannot  be  later  used  as  a 
variable  or  array  identifier.  The  various  functions  in  class  f  are  dis¬ 
tinguished  from  one  another  through  the  use  of  the  qualifier  n.  For  example 
G^(X)  -  X^  and  ^(X)  •  X  are  two  functions  in  class  G;  G  *-  3  is  an  Illegal 
statement.  6  and  G  are  not  in  class  G.  As  many  function  classes::  as  de  ired 


23  September  1971 


7 


System  Development  Corporation 
TM-4 790/000/00 


may  be  defined.  The  optional  parameters,  p  ,  must  be  legal  identifiers.  The 
same  identifier  may  be  used  as  a  parameter  in  many  function  definitions  and  also 
as  a  variable  or  array  name  or  as  a  function  class. 

4.2.2  Use 

An  example  of  a  function  definition  and  call: 

Function  definition: 

a3(a,b)  -fa) 
vU” 


) 


Function  call: 

e  «-  a 


To  exponentiate  the  value  returned  by  a  function,  it  is  permissible  to  write 
(for  function  a,  parameters  b,c,  exponent  2): 

a2(b,c) 

or 

a(b,c)2 


4.3  INPUT  STATEMENT 

Because  TAM  requests  values  for  undefined  quantities  as  they  are  encountered, 
user-directed  input  is  seldom  necessary.  However,  an  input  statement  is  pro- 
vlded  so  that  the  user  may  guide  the  order  of  quantity  setting  in  a  direct 
fashion  and  so  that  he  may  reset  quantities  easily. 


4.3.1  Form 

□  -*•  list 

where  the  list  consists  of  legal  identifiers  of  simple  variables  or  arrays 
separated  by  commas. 
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A . 3 . 2  Use 

The  statement  results  in, a  request  for  input(s)  from  the  user.  A  value  for 
each  element  in  the  list  is  requested  in  turn.  For  example:  , 

□  ■*  ft, a 

results  in  the  user  being  prompted  with: 

n 

Hopefully,  the  user  will  then  respond  with  a  value  for  ft. 

I 

TAM  will  then  request  a  value  for  a  by  writing: 

a  + 

;  1  : 

Once  again,  the  user  is  expected  to  input  a  value  for  a. 

1  1  '  i 

4.4  OUTPUT  STATEMENT 

,  i 

4.4.1  Form 

'  list 

i  i  i 

where  the  list  consists  of  expressions  ,or  identifiers  separated  by  commas. 

4.4.2  Use 
The  statement: 

B,  3  +  5  , 

results  in  the  output 


*  i  i 

assuming  B  has  been  defined  as  the  given  matrix.  If  B  has  not  yet  been 
defihed,  the  following,  rather  unusual,  result  occurs.  The  user  is  first 
asked  to  input  a  value  for  B  by  the  prompt: 

I  i  r 

B  - 

After  receiving  B,  TAM  ouputs  it. 


4  rA 

J  I 

<> 


I 


I 
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4.5  LOOP  CONTROL 

An  assignment  statement.  Input  statement,  or  output  statement  may  be  Iterated 
by  following  the  statement  with  loop-control  information. 

4.5.1  Forms 

Loop  control  may  be  specified  In  three  forms.  Loops  may  be  nested  to  any 
level,  but  each  loop  variable  in  the  nest  must  be  unique. 

4.5. 1.1  Loop  Control,  Form  1 

Statement:  i*m,...,n 

where  la  the  loop  variable  (an  identifier  of  a  simple  variable  whose  value 
will  be  incremented  by  one  for  each  iteration  of  the  statement),  m  is  the 
initial  value  for  i,  and  n  is  the  terminal  value,  m  and  n  may  be  any  legal 
expressions  that  yield  single  numeric  values.  The  iteration  is  complete 
when  i  exceeds  n.  The  statement  iterated  may,  but  need  not,  contain  references 

to  1. 

4. 5. 1.2  Loop  control,  Form  2 

Statement:  i^m^.n^, . . .  ,n 

where  is  the  loop  variable,  m^  and  m2  are  the  first  two  values  for  i  as 
the  statement  is  iterated,  n^-m^  defines  the  loop  increment  (or  decrement), 
and  n  is  the  terminal  ’  *lue.  and  n  may  be  any  legal  expressions  which 

yield  single  numeric  values.  The  iteration  is  complete  when  i  exceeds  (or 
becomes  less  than)  n.  The  statement  iterated  may,  but  need  not,  contain 
references  to  i. 

4. 5. 1.3  Loop  Control,  Form  3 

Statement:  i^^.m^.m^.m^, . .  .mn 

where  i  is  the  loop  variable  and  the  m^  are  successive  settings  for  i  each  time 
the  statement  is  iterated.  The  elipsis  (...)  shown  is  not  a  part  of  the 
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loop- control  fora,  as  It  Is  In  the  two  previous  forms,  but  Is  Included  to 

Indicate  that  the  list  m^  Is  of  user-determined  length.  The  loop  terminates 

after  the  statement  has  bean  executed  for  1-m  .  The  statement  may,  but  need 

n 

not,  contain  references  to  1. 

4.3.2  Use 
For  example: 

X.  4«-Y«HJ:i-l,...,5:  J-2,4,...,8 
i  •  j 

Is  an  Instance  of  a  tvo-level  neat  of  loop  control.  The  level  of  nesting 
proceeds  froei  right  to  left,  l.e.,  J  Is  the  outer  control  variable,  1  Is  the 
Inner  control  variable. 

Another  example: 

A-A+B :  B-86  .vtf',  ‘‘■7.1+1 

B  ...uae.  the  value.  86  ,v4,  U .  7 , 1+J  for  aucceaalve  iteration,  of  the  loop. 

The  final  value  for  A  Is  the  sum  of  these  values  plus  the  original  contents 
of  A. 


4.6  BUILT-IN  FUNCTIONS 

TAM  includes  a  set  of  bullt-ln  functions  that  the  user  can  activate  by  In¬ 
cluding  one  of  the  names  given  below  (along  with  an  appropriate  parameter)  with¬ 
in  any  context  In  which  a  function  call  Is  permissible.  (In  expressing  the 
name,  any  combination  of  uppercase  and  lowercase  Roman  letters  Is  permissible; 
e.g.,  ln=ln=LN.).  The  available  functions  are: 


Name  and  Parameter 

•ln(x) 

cos(x) 

ten(x) 

cot(x) 

arctan(x) 


Definition 
slne(x> 
cosine (x) 
tangent(x) 
cotangent (x) 
arctangent (x) 


tan-1 (x)  arctangent (x) 

ln(x)  natural  logarlthm(x) 

The  arguments  are  In  radians  for  the  trlgnometrlc  functions. 


4  Js*. 
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5.  INPUTTING  AND  EDITING  TAM  STATEMENTS 

5.1  OVERVIEW 

TAM  statements  are  input  In  hand-written  two-dimensional  form  through  a  RAND- 
Tablet  display  device.  TAM  uses  a  previously  constructed  dictionary  of 
patterns  describing  the  user's  individual  handwriting  characteristics  and 
defining  the  recognizable  character  set  (see  Appendix  A). 

Once  active  at  the  terminal,  TAM  asks  for  a  file  description  of  this 
dictionary: 

OLD  DICTIONARY  - 

The  user  then  responds  with  the  appropriate  file  description. 

TAM  then  displays  a  set  of  "pushbuttons"  (e.g.,  the  words  "Exit"  and  "Erase") 
that  allow  the  user  to  direct  subsequent  operations.  The  TAM  pushbuttons 
and  their  meanings  are  given  in  Section  5.2. 

To  start  operating,  the  user  writes  a  TAM  statement  on  the  face  of  the 
display.  The  line  will  be  parsed  as  recognized  and  an  encoded  form  of  the 
line  will  appear  (see  Appendix  B  for  encoding  characters).  The  user  can 
then  operate  on  his  statement  through  use  of  the  pushbuttons.  As  TAM  operates, 
a  history  display  is  built  of  the  last  four  legal  lines  and  any  associated 
output.  Any  of  the  last  four  lines  entered  can  be  recalled  for  editing  and/or 
reoperatlon. 
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5.2  PUSHBUTTONS 


Figure  1.  TAM  Pushbuttons 

Function 

The  most  recently  Input  user  characters,  their  related  parsed 
display,  and  any  associated  record  In  the  Interpreter  Interface 
are  deleted.  A  new  or  recalled  line  is  now  expected. 

Move  The  designated  user  characters  are  moved  as  specified  by  the 

editing  stroke(s).  The  move  operations  and  how  they  are 
Indicated  are: 

Open-up — a  single  horizontal  line  drawn  on  or  between  pre¬ 
viously  scripted  characters.  A  space  equal  to  the  length  of 
the  line  is  made  between  the  selected  characters.  The  Initial 
point  of  the  line  determines  the  location  of  the  space  and  the 
direction  of  the  line  determines  the  direction  In  which  the 
affected  characters  are  moved. 

Cloae-up — two  horizontal  lines,  similar  to  an  equal  sign,  drawn 
in  a  space  between  previously  scripted  characters.  The 

■«  V 


Button 

Erase 
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Button 

Move  (cont'd) 


Context 


TAM 


Latest 


Function 

characters  to  the  right  of  the  editing  strokes  are  moved  to 
the  left  a  distance  equal  to  the  length  of  the  longest  of 
the  editing  stroke  pair. 

Move  character — a  circle  or  a  rectangle,  drawn  as  one  stroke, 
followed  by  a  single  line.  The  characters  enclosed  by  the  circle 
or  rectangle  are  moved  the  length  and  direction  of  the  line. 

This  button  may  be  used  in  conjunction  with  the  Move-character 
operation  and  the  character  scrub  (the  latter  consists  of  rubbing 
out  characters  with  the  pen).  If  the  Context  button  Is  pushed 
Immediately  prior  to  the  scrub  action,  any  characters  logically 
attached  to  the  scrubbed  character,  such  as  a  superscript,  are 
erased.  If  the  Context  button  Is  used  In  place  of  the  Move 
button,  any  characters  logically  attached  to  a  character  enclosed 
by  the  first  stroke  of  the  move  character  are  also  moved. 

The  current  user  characters  are  processed  by  the  Interpreter. 

If  no  characters  exist,  the  action  Is  taken  as  a  cancel  signal. 
When  the  current  line  becomes  the  history  display,  the  program 
Is  ready  for  new  Input.  The  Interpreter's  output.  If  not  an 
error  message,  Is  joined  with  the  parsed  representation  of  the 
user's  scripted  input  and  added  to  the  history  display,  and  the 
previous  entry  In  the  history  display  is  deleted.  An  Internal 
program  history  pointer  is  set  to  the  most  recent  history  entry. 

The  user  characters  in  the  history  display  are  regenerated  and 
displayed . 


23  September  1971 


14 


System  Development  Corporation 
TM-4 790/000/00 


5  t 


Function 

The  history  pointer  Is  moved  from  Its  current  position  to  the 
next  older  entry.  The  entry's  user  characters  are  then 
regenerated  and  displayed. 

Forward  The  history  pointer  Is  moved  from  Its  current  position  to  the 

next  more  recent  entry.  The  entry's  user  characters  are  then 
regenerated  and  displayed. 

Quit  Terminate  TAM. 

6.  UNCONSTRAINED  TAM 

6.1  MINIMUM  DECLARATION 

One  of  the  Important  design  goals  of  TAM  is  that  the  user  be  freed  from 
unnecessary  or  ordered  declaration  of  storage,  quantities,  or  functions.  One 
manifestation  of  this  freedom  Is  that  an  array  of  elements  need  not  be 
explicitly  dimensioned  until  the  user  wishes  to  operate  with  the  array  as  an 
entity,  l.e.,  as  a  matrix  or  vector;  so  long  as  the  user  deals  with  his 
array  element  by  element,  no  explicit  dimensioning  is  necessary.  Before  the 
array  Is  first  used  as  a  whole,  the  user  must  dimension  It.  Then,  when  the 
array  Is  used,  the  user  Is  asked  to  set  elements  that  do  not  yet  have  values. 
In  setting  array  values,  the  user  may  either  override  or  maintain  existing 
values . 

TAM  gives  the  user  this  freedom  by  Incorporating  the  following  techniques. 

An  ldentlfler~a  single-letter  name  along  with  any  overscore  and/or  under¬ 
score  characters  expressed  with  the  letter— Is  classified  Into  one  of  two 
classes,  function  or  variable,  on  the  basis  of  Its  first  usage.  That  Is, 
the  four  distinct  Identifiers 
A  A  A  A 

e  e 

will  be  separately  classified  according  to  how 


Button 

Backward 
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they  are  first  used.  Subscripts  used  with  Identifiers  discriminate  between 
class  members  by  type.  Each  member  of  a  class  has  associated  with  It  a  type: 
list,  vector,  array,  or  function. 

For  example: 

•  »  • 

A^  *■  3  sets  A  to  class  'variable'  and  A^  to  type  'list'. 

Before  A  can  be  used  as  a  vector,  dimensioning  information  must  be  given  about 
•  • 

A.  The  type  of  A  there  will  be  set  to  'vector'.  If  necessary,  TAM  will 
demand  values  for  unset  members  of  class  A  when  it  is  used. 

6.2  DEMAND  INPUT 

TAM  further  frees  the  user  from  ordered  statements  in  that  quantities  to  be 
manipulated  need  have  values  only  when  used.  TAM  automatically  provides 
the  necessary  prompting.  For  example: 

A  «■  2  +  Y 

as  the  first  TAM  statement  would  result  in  the  request 

2  + 

to  which  the  user  would  be  expected  to  respond  with  a  value  or  expression. 

If  the  user's  response  contains  unknown  quantities,  TAM  also  requests  values 
for  these.  Once  a  value  for  2  is  ascertained,  TAM  requests  Y: 

Y  - 


Once  again,  a  value  or  expression  is  mandatory.  Once  all  quantities  are  defined, 

A  is  set  to  the  value  of  the  original  expression  2  +  Y. 

■ 

6.3  NATURAL  EXPRESSION  OF  OPERATION 

TAM  allows  the  user  to  express  standard  mathematical  operations  in  a  natural 
way.  Two-dimensional  input  is  TAM's  outstanding  facility  in  this  regard.  In 
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addition,  two  features  of  standard  notation  usually  disallowed  in  programming 
languages  are  permitted  in  TAM:  implicit  multiplication  and  embedded 
exponentiation  in  function  calls. 

6.3.1  Implicit  Multiplication 

TAM  allows  the  user  to  imply  the  multiplication  operator.  The  nature  of  TAM 
identifiers  eliminates  contextual  confusion.  The  following  are  examples  of 
implied  multiplication: 


ab  ->  a*b 

c(de)  ->  c*(d*e) 

5  5 

e  I  14  ■>  e*  I  i*4 
i-3  i-3 


Note:  ij!  ->  i*(jl) 

(ij)I  ->  (1*J) ! 
and  ab2  ->  a*(b2) 

(ab)2  ->  (a*b)2 

6.3.2  Embedded  Exponentiation 

Exponentiation  of  the  value  returned  by  a  function  can  be  expressed  in  either 
of  two  ways : 

sin  (a)2  ->  (sin(a))2 

or 

sin2(a)  ■>  (sin(a))2 

That  is,  the  exponent  may  appear  immediately  after  the  full  function  call 
(which  Includes  parameters)  or  immediately  adjacent  to  the  function  name, 
before  the  parameters. 
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7.  ERROR  CONDITIONS 

TAM  legality  checks  each  statement  before  attianptlng  to  execute  It.  If  an 

Illegality  Is  discovered,  the  statement  is  rejected  and  an  appropriate  message 

Is  generated. 

7.1  USER  ERRORS 

The  most  freHuent  error  message  generated  by  TAM  is: 

SYNTAX  ERROR  AT  CHARACTER  XX 

where  XX  is  the  relative  character  position  (in  the  parsed  string)  of  the 

illegality.  Other  possible  error  messages  are: 

Message  Meaning 

TYPE  ERR  1.  An  identifier  defined  as  a  function 

name  is  being  used  as  a  variable. 

2.  An  identifier  defined  as  a  variable 
or  array  name  is  being  used  as  a 
function. 

3.  The  control  variable  in  a  loop 
statement  is  an  array  or  function 
name. 

X!  X  *  INTEGER  2  0  The  factorial  operator  is  defined  for 

positive  integers  only. 

CLASS  ERR  1.  An  identifier  which  is  a  member  of  a 

a  class  of  functions  is  being  used 
as  a  variable. 

2.  An  identifier  which  is  in  a  variable 
or  array  class  is  being  defined  as 
a  function. 
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Message 

OPERATION  ERR  -  ARRAY/ VECTOR 


XY  ,  X<Q  Y  *  INTEGER 

PARAMETER  ERR 

«  COLUMNS /ROWS 

SUBSCRIPTS  MUST  BE  INTEGERS 

SINGULAR  MATRIX,  NO  SOLUTION 

LOG  OF  -  OR  Q  ARG  RETURNS  -  INFINITY 


Meaning 

An  operator  is  being  used  which  is 
meaningless  if  one  or  both  operands 
is  an  array  or  vector. 

y 

1.  X  ,  Y  is  a  vector  or  array. 

Y 

2.  X  ,  Y  is  not  an  integer,  X  is  an 
array  or  vector, 

3.  An  array  or  vector  name  is  being  used 
as  a  subscript. 

For  negative  X,  only  exponentiation 
to  an  integral  power  is  defined. 

The  number  of  parameters  in  a  function 
call  does  not  match  the  number  of  para¬ 
meters  in  the  definition. 

In  a  block  input  of  an  array,  the  columns 
are  of  unequal  length  or  the  rows  are 
of  unequal  width. 


An  attempt  to  Invert  a  singular  matrix 
has  been  made. 

Ln(X) ,  X  c  Q 

returns  a  very  small  number. 


SYMBOL  OR  STRING  TOO  LONG 
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Message  Meaning 

MISMATCHED  DIMENSIONS  An  arithmetic  operation  on  two  arrays 

has  been  attempted.  The  nature  of  the 
arrays  precludes  the  operation. 

EXPONENT  OVERFLOW  EXCEPTION 

EXPONENT  UNDERFLOW  EXCEPTION 

SIGNIFICANCE  EXCEPTION 

FLOATING  DIVIDE  EXCEPTION 

FLOAT  /-  NO.  An  array  or  vector  has  been  specified 

In  a  context  that  demands  a  simple 
variable,  e.g.,  as  a  preset  value  for 
an  array  or  vector. 


7.2  INTERPRETER  ERRORS 

The  following  messages  should  not,  but  may,  appear.  The  program  will  stop. 
The  messages  signal  errors  In  the  TAM  Interpreter.  If  one  of  the  following 
messages  Is  encountered,  a  register  and  core  dump  should  be  taken  and  the 
TAM  maintenance  personnel  contacted. 

AN  UNDEFINED  ROUTINE  HAS  BEEN  CALLED 
BAD  CAR 
BAD  CDR 

GENERATOR  DOES  NOT  MATCH  ITS  PARAMETERS 
ALL  BOOLEANS  OF  AN  EXPRESSION  ARE  FALSE 
BAD  CADDDR 
BAD  CADDDR2 


) 


I 


i  i 

:  f  i 

'■  1  i  ' 
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BAD  CADDDR3 
BAD  CADDR4 
BAD  CADDR 
BAD  CADDR2 
BAD  CADDlti 

BAD  CADR  < 

BAD  CADR2 
BAD  CADDDDR 
BAD  CDDDDR2 

BAD  CDDDDR3  , 

BAD  CDDDDR4 
BAD  CDDDR 
BAD  CDDDR2 
BAD  CDDDR3 

BAD  CDDR  < 

.  BAD  CDDR2 
X  NOT  A  CHARACTER 

•I  I  ; 

BAD  COMPRESS  OF  ATOM 
B^D  OUTNUM2 

ROOF  x  y  COMPILER  ERROR 
BAD  CONS  ' 

BAD  DEF1 
BAD  DEF2 

1  GETT  x  COMPILER  ERROR 

t  '  I 

NOT  ENOUGH  SPACE 
COMPILER  ERROR  HALT 

7.3  CAPACITY  OVERLOAD  ERRORS 

i  1  I  , 

The  following  massages  signal  that  the  capacities  of  JAM  have  been  exceeded. 

1  i 

The  program  will  stop.  If  one  of  these  messages  is  encountered  and  the  excess 
seems  unwarranted  or  ill  defined,  a  core  and  register  dump  shodld  be  taken 
1  and  TAM  maintenance  personnel  bontacted.  , 
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FULL  UNDEFINED  STACK 
FULL  BACKUP  STACK 
FULL  ARGUMENT  CTACK 
NO  MORE  ARRAY  SPACE 
NOT  ENOUGH  ARRAY  SPACE 
NOT  ENOUGH  LIST  SPACE 
NO  MORE  LARGE  NUMBER  SPACE 
NO  MORE  REAL  NUMBER  SPACE 
NO  MORE  GENSYM  SPACE 
NOT  ENOUGH  STRING  SPACE 


I 
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APPENDIX  A 

BUILDING  A  TAM  DICTIONARY 


To  operate  TAM,  the  user  must  have,  at  some  previous  time,  built  a  dictionary 
of  recognizable  characters.  This  dictionary  provides  the  information  to  allow 
TAM  to  recognize  and  accept  the  user's  Individual  handwriting  and  character 
set.  Each  character  to  be  used  with  TAM  must  be  entered  into  the  dictionary. 

A  program,  BUILDER,  is  provided  for  dictionary  construction.  The  program  will 
either  create  a  new  dictionary  or  allow  the  user  to  modify  and  amplify  an 
existing  one. 

Using  the  Dictionary  Builder 
After  signing  on,  the  program  asks: 

CONTINUE  W/  OLD  DICT  ?  Y/N 

A  "Y"  answer  will  cause  the  program  to  request  file  description  information 
and  open  an  old  dictionary  file.  An  "N"  arswer  causes  the  program  to  assume 
a  new  dictionary  is  being  built. 

Function  pushbuttons  will  then  appear  on  the  display.  The  pushbuttons  and 
their  functions  are: 


Pushbutton 


Function 


Save 

Build 

Test 

Sumry 

Print 

Quit 


Save  the  dictionary  on  disc  or  tape 

Build  a  dictionary 

Test  the  dictionary  definitions 

Print  a  summary  of  the  dictionary  contents 

Print  a  detailed  description  of  the 

dictionary 

Quit  the  program 


(Only  the  Build  and  Save  functions  will  be  described.) 


4 
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Build  Function 

The  user  builds  a  dictionary  containing  stroke  Information  and  the  definition 
associated  with  the  strokes.  The  stroke  Information  consists  of  the  user's 
own  Individual  characteristics  in  drawing  characters. 

Sampling  Mode: 

The  program  asks  for  user  Input  by  dis¬ 
playing  "INPUT"  at  the  top  of  the  dis¬ 
play.  The  user  then  Inputs  the  strokes 
he  wants  to  define.  Note  that  the 
strokes  need  not  be  similar  to  each 
other. 


Keyboard 

Input  strokes 

Dictionary  matches/no  matches 


Keyboard  pushbuttons 


Threshold  pushbuttons 
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Keyboard,  keyboard  pushbuttons.  There  are  five  keyboards,  each  consisting  of 
a  unique  set  of  definitions.  The  user  selects  the  set  containing  the  defini¬ 
tions  he  needs  by  touching  one  of  the  keyboard  pushbuttons:  "S"  for  special 
characters,  such  as  the  asterisk  and  plus  sign,  "G"  for  Greek  characters,  "N" 
for  numerals  0  through  9,  "U"  for  upper  case  Roman  alphabet,  and  ”L"  for  lower 
case  Roman  alphabet . 

The  uppercase  Roman  alphabet  is  the  first  keyboard  set  displayed;  the  last  set 
selected  will  be  displayed  at  the  top  of  the  display  until  another  set  is 
selected. 

Dictionary  matches/no  matches.  Each  stroke  is  analyzed  and  compared  to  defi¬ 
nitions  already  in  the  dictionary.  If  a  match  has  been  found  (matches  are 
subject  to  threshold  values  described  below),  the  character  associated  with 
that  match  is  displayed  directly  below  the  stroke.  This  character  will  either 
belong  to  one  of  the  keyboard  sets  or  be  a  backward  "S".  The  backward  "S" 
represents  a  match  in  the  dictionary  that  has  no  character  definition,  i.e.,  is 
only  a  part  of  a  defined  character. 

If  no  match  has  been  found,  a  backward  (to  distinguish  it  from  the  character 
"?")  question  mark  is  displayed  directly  below  the  stroke. 

These  deflnes/undef ines  are  displayed  about  an  inch  below  the  string  of  input 
strokes,  each  define /undefine  aligned  with  its  stroke,  at  successively  lower 
levels  to  prevent  overlapping  of  definitions. 

If  the  strokes  are  input  below  the  bottom  third  of  the  screen,  or  if  the  layering 
of  deflnes/undef ines  results  in  the  overlapping  of  pushbuttons,  then  the  defines/ 
undeflnes  appear  above  the  threshold  pushbuttons  in  the  order  in  which  their 
corresponding  strokes  were  drawn. 
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Threshold  pushbuttons.  These  buttons  appear  at  the  bottom  center  of  the  dis¬ 
play,  "RT"  for  reduced  thresholds  and  "it"  for  increased  thresholds.  A  box 
appears  around  the  threshold  button  last  selected;  the  reduced  thresholds  are 
in  effect  first.  These  thresholds  are  used  in  determining  whether  or  not  a 
match  exists  for  a  given  stroke /strokes. 


Program/ Control  pushbuttons. 

Redefn  Redefine  button,  allows  the  user  to  change  a  dictionary 

definition. 


Forget 

Erase 

Exit 


Forget  button,  ignore  a  previous  action. 

Clear  the  display  and  return  to  the  sampling  mode  ("INPUT" 
displayed. ) 

Leave  the  Build  function  and  return  to  function  selecting 
mode. 


Defining  Mode. 


V 

4  r  ^  v 

odX W&  '°7*1 

0  f  r  CTV  TTVC 

T  T 

s 

Q. 

-  n 

N 

P  0  IT 

A  definition  is  entered  in  the  dictionary 
by  circling  the  stroke/strokes  or  either 
end  point  of  a  stroke  and  touching  the 
corresponding  character  in  the  keyboard. 

These  definitions  may  be  entered  one  at  a 
time  or  as  many  as  the  user  wishes,  subject 
to  program  limitations. 


23  September  1971 


26 


System  Development  Corporation 
TM-4790/000/00 


*■  t. 

0  12  in'.  <o 

71  r 

0  l  2  3  4  C  c 

<T 
f 

<T  <T 

0 

V 

The  matches/no  matches  appear  again  below 
the  input  strokes.  There  may  be  all 
matches  or  there  may  still  be  some  fail¬ 
ures  to  match,  as  shown  at  the  left. 

The  user  may  define  the  strokes  for  which 
no  matches  exist  until  all  have  matches 
in  the  dictionary. 


Note:  The  possible  matches  are  done  using  the  thresholds  in  effect.  Increas¬ 
ing  the  threshold  values  by  touching  the  "it"  pushbutton  may  result  in  more 
matches . 


To  change  the  current  definition  in  the  dictionary  for  a  certain  stroke  or 
strokes,  the  user  should  first  touch  the  "Redefn"  pushbutton  and  then  define 
the  stroke  or  strokes  in  the  manner  described  above. 


When  satisfied  that  the  current  set  of  strokes  has  been  properly  defined, 
the  user  should  touch  either  the  "Erase"  pushbutton  to  input  a  new  set  of 
strokes  or  the  "Exit"  pushbutton  to  leave  the  Build  mode. 

Save  Function 

To  save  the  dictionary  just  built  (for  future  use  with  TAM  or  for  subsequent 
amplification),  the  user  should  touch  the  "Save"  pushbutton.  The  program 
then  requests  a  file  identification  (on  the  terminal).  If  a  new  file  is  to 
be  opened,  'N'  must  be  included  in  the  file  identification.  Once  the 
dictionary  has  been  saved  successfully,  the  message  "DICT  SAVED"  appears  on 
the  terminal. 
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APPENDIX  B 


CHARACTER  CODES  -  STRING 


HEX 

Octal 

Decimal 

Parse 

Cl 

301 

193 

t 

C2 

302 

194 

/ 

v 

C3 

303 

195 

\ 

C4 

304 

196 

1 

C5 

305 

197 

\ 

D1 

327 

209 

[ 

D2 

322 

210 

] 

D3 

323 

211 

{ 

D4 

324 

212 

* 

D5 

325 

213 

i 

D6 

326 

214 

D7 

327 

215 

{ 

D8 

330 

216 

* 

D9 

331 

217 

i 

DA 

332 

218 

> 

EO 

340 

224 

— 

FO 

360 

240 

» 

FI 

361 

241 

F2 

362 

242 

n 

F3 

363 

243 

X 

F4 

364 

244 

U 

F6 

366 

246 

• 

9 

FD 

375 

253 

String 

FE 

376 

254 

String 

PARSER-GENERATED  CHARACTERS 
Symbol 

Overscore;  Upper  Integral  limit 

Superscript 

Subscript 

Underscore,  Lower  Integral  limit 
Sq.  Rt.  Index 
Left  Bracket 
Right  Bracket 

Numerator  and  Denominator  enclosures 

Multiple  overscore  enclosures 

Matrix  enclosures 

Combinatorial  enclosures 

Square  Root  Bar 
Matrix  Element  Separator 
Fraction  line 

Multiple  overscore  Indicator 
Multiply  cross 

Multiple  underscore  Indicator 

Matrix  Row  Separator 

Start 

End 
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USER  INPUT  CHARACTERS 


Octal 

Hex 

Character 

Octal 

Hex 

Character 

000 

00 

n/a 

040 

20 

Blank 

001 

01 

a 

041 

21 

1 

• 

002 

02 

8 

042 

22 

II 

003 

03 

a 

043 

23 

# 

004 

04 

6 

044 

24 

$ 

005 

05 

e 

045 

25 

Z 

006 

06 

* 

046 

26 

& 

007 

07 

n 

047 

27 

■* 

010 

08 

X 

050 

28 

r 

Oil 

09 

M 

051 

29 

012 

OA 

Y 

052 

2A 

* 

013 

OB 

n 

053 

2B 

+ 

014 

OC 

p 

054 

2C 

• 

015 

OD 

0 

055 

2D 

- 

016 

OE 

T 

056 

2E 

• 

017 

OF 

\ 

057 

2F 

/ 

020 

10 

/ 

OfO 

30 

0 

021 

11 

— - 

061 

31 

1 

022 

12 

> 

062 

32 

2 

023 

13 

1 

063 

33 

3 

024 

14 

l 

064 

34 

4 

025 

15 
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